home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / comm / tag15106.zip / TAGFILE.TXT < prev    next >
Text File  |  1992-01-23  |  20KB  |  443 lines
  1. TAGFILE v1.51     by Tom Hansen, SysOp      Church Chatters (tm) BBS
  2.  
  3.  
  4. TAGFILE a utility for BATCH uploading:
  5.  
  6. Please give feedback on this program.  I hope to keep this program
  7. under 30k in size though that may be a pipe dream.
  8.  
  9. Your suggestions can only make this better!
  10.  
  11. Send suggestions to Church Chatters BBS
  12. Public Access number 402-593-8863
  13.  
  14. Future enhancements:
  15.  
  16. 1.) Downloading capabilities though that can already be done
  17.     with the configurable switches in DGS.DEF.   The intention
  18.     is not to provide a download utility but one for uploads.
  19.     Your bidirectional options will handle the downloading
  20.     for you as well.
  21.  
  22. 2.) Better Documentation.
  23.  
  24. Files included in this archive include:
  25.  
  26. TAGFILE.EXE : Main control program.
  27. DIRN.EXE    : File Tagging utility called by TAGFILE.EXE.  This may be run
  28.               independantly of TAGFILE.EXE
  29. DGS.DEF     : Sample configuration file.
  30. TAGFILE.TXT : This document.
  31. ID.BAT      : Batch file for processing DIZ ( prepared descriptions ) files.
  32. TAGFILE.SLT : Salt file for compiling macro script for TELIX
  33. TAGFILE.SLC : Compiled TAGFILE.SLT script.
  34. DESC.SDI    : Desctripion of Program for BBS posting ( inserted by TAGFILE )
  35.  
  36. 1.) Edit DGS.DEF to match your system.  Be sure the executable files are
  37.     either in your path or your current subdirectory. ( Executable programs
  38.     called by TAGFILE are DSZ.COM( or DSZ.EXE), HSLINK.EXE, BIMODEM.COM and
  39.     DIRN.EXE ).  User defined programs are the editor (Line 9 of DGS.DEF)
  40.     and the optional protocol ( Lines 7 and 8 of DGS.DEF).  The editor is
  41.     menu selection E ( used in various other functions as well ) and the user
  42.     defined protocol is menu selection M.  The descritpion on line 8 for menu
  43.     selection M should be no longer than 21 chars.
  44.  
  45.  DGS.DEF outline   :
  46.  
  47. Line  1: test.lst          <- Name of file listing tagged files (No Path needed);
  48. Line  2: handshake both sz <- DSZ Command line (Zmodem);  Tagfile will pass
  49.                               your port number and speed as to DSZ.COM or to
  50.                               DSZ.EXE ( see line 12 ) and the tagged files.
  51. Line  3: ha both sb        <- DSZ Command line (Ymodem-g);
  52. Line  4: ha both sb -k     <- Ymodem command line.
  53. Line  5: -@ -NV -UC:\BOYAN\DL -S2048 <- HS/Link parameters. HS/Link will auto
  54.                               detect your comport speed.
  55. Line  6: /I BIMOD1.LOG     <- Bimodem Parameters ( Port, Speed, and tagged
  56.                               files are passed by TAGFILE
  57. Line  7. c:\boyan\dl\      <- Subdirectory to recieve files into.  Be sure
  58.                               the trailing backslash is on this line or it
  59.                               will not work for you.
  60. Line  8: PUMA P2 HF S@TEST.LST  <- User configurable protocol to execute.
  61. Line  9: Puma Batch        <- User configurable menu entry. Executes Line 8.
  62. Line 10: c:\qed\q.exe      <- Path to your favorite text editor( QEdit
  63.                               recommended). Be sure TAGFILE can find your
  64.                               editor, that it is in your current directory,
  65.                               in your DOS path or that you enter the path in
  66.                               the configuration file as shown in the example.
  67.  
  68. Line 11: 2                 <- Communications port you COMM program uses.
  69.                               Currently Tagfile will only work on com ports
  70.                               1 and 2.
  71. Line 12: 19200             <- Communications port speed
  72. Line 13: COM               <- If using DSZ.COM enter COM here. If using EXE
  73. Line 14: DESC.SDI             enter EXE.  If this line is optional. If left blank
  74.                │              TAGFILE.EXE will default to DSZ.COM.
  75.                └────── -> Text file created by TAGFILE with file descriptions
  76.                           for files uploaded in batch mode.
  77.  
  78.  
  79. See sample DGS.DEF file included here.
  80.  
  81. 2.) To run this utility setup a macro in your communications program;
  82.  
  83. BOYAN:
  84. I set mine up in Boyan for the "F9" key. To do this in Boyan, load
  85. BOYAN.COM.  Enter "ALT-C" to configure boyan.  When the configuration
  86. menu shows enter "M" for macros.  Pick the key you want to use from
  87. the menu selections and then enter the prompt as follows:
  88. \DC[TAGFILE]
  89.  
  90. TELIX:
  91. Use the TAGFILE.SLC or compile your own with the TAGFILE.SLT file using
  92. CS.EXE that comes with Telix.  Go into Telix and define any macro to
  93. execute @TAGFILE
  94.  
  95. TAGFILE.EXE and DIRN.EXE are in your path or your current subdirectory.
  96. And make sure the editor, DSZ and other protocols are in your path or
  97. current subdirectory as well. When you load tagfile pass the path and
  98. name of your configuration file to it as follows.  TAGFILE C:\SUBDIR\DGS.DEF.
  99.  
  100.  
  101. The commands on the menu are self explanitory.  The "S" will send the
  102. upload command to the host system along with the file names of the
  103. tagged files.  Once the command is sent you will be returned to your
  104. communications package in case you haven't told your favorite BBS which
  105. protocol you want to use.  Once you have done so return to tagfile and
  106. press the upload key for the protocol you wish to use.
  107.  
  108. Your TAGFILE Menu looks as follows:
  109.  
  110.  
  111.  
  112.      │▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀│
  113.      │       ----*>>> Tagfile v1.51.06ß Unregistered! <<<*----    │ ░░
  114.      ├────────────────────────────────────────────────────────────┤ ░░
  115.      │ [T] Tagfiles                     [A] Add file to List      │ ░░
  116.      │ [C] Change Tagfile Name          [S] Send UL Command to BBS│ ░░
  117.      │ [E] Edit File List                                         │ ░░
  118.      │ [K] Kill File List               [ESC] to Exit             │ ░░
  119.      │ [F] Description - DESC.SDI       [PGUP] Upload Files       │ ░░
  120.      │                                  [PGDN] Download Files     │ ░░
  121.      ├────────────────────────────────────────────────────────────┤ ░░
  122.      │ F2 = Os Shell                                              │ ░░
  123.      └────────────────────────────────────────────────────────────┘ ░░
  124.        ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  125.  
  126.      TAGFILE command <?,T,C,E,K,F,O,A,D,U,S>?
  127.  
  128.  
  129.  
  130. Commands:
  131.  
  132.  1. T = Tagfiles.  TAGFILE.EXE comes with a file tagging utility which
  133.                    can be used with or without TAGFILE. It is called
  134.                    DIRN.EXE.  When this utility is called it reads the
  135.                    first line configuration file (DGS.DEF) and knows
  136.                    to append files to this list.  If it does not find
  137.                    the list or you have deleted the list then it will
  138.                    create a new one with the name you specify.
  139.  
  140.  
  141.                    When you enter T at the menu prompt you will first
  142.                    be presented with this screen:
  143.  
  144. ╓──────────────────────────────────────────────────────────────────────────────╖
  145. ║                                                                              ║
  146. ║    Press ENTER for current directory.                                        ║
  147. ║    Or enter subdirectory only. Example: C:\TEST                              ║
  148. ║                                                                              ║
  149. ║     Display which subdirectory?                                              ║
  150. ║    :                                                                         ║
  151. ║                                                                              ║
  152. ╙──────────────────────────────────────────────────────────────────────────────╜
  153.  
  154.        You may enter the subdirectory you wish to search at this
  155.        time.  It can be a different drive than your current drive
  156.        as well.  The important thing to remember is not to leave
  157.        any trailing back slashes.  If I wanted to tag files in my
  158.        communications DL directory for uploading to other systems
  159.        I would enter "C:\BOYAN\DL" at the prompt (without quotes of
  160.        course).
  161.  
  162.        The next step would be to enter the file search specifications.
  163.        Aftering entering the subdirectory to search you then need to
  164.        enter those.  The menu you will be presented to enter your
  165.        specifictions looks like this:
  166.  
  167. ╒══════════════════════════════════════════════════════════════════════════════╕
  168. │                                                                              │
  169. │                                                                              │
  170. │                                                                              │
  171. │           ENTER for default: *.*                                             │
  172. │                                                                              │
  173. │         File Search Specifications :                                         │
  174. │                                                                              │
  175. ╘══════════════════════════════════════════════════════════════════════════════╛
  176.  
  177.       As you can see, a carriage return will display all the files
  178.       in the subdirectory you specified above.  Let's say I had some
  179.       specific files I wanted to upload and I knew what they were.
  180.       With the new HS/Link protocol being released there are alot of
  181.       files going around beginning with the letters HS.  For convenience
  182.       in searching all my files for all of them I will then enter
  183.       "HS*.* at this prompt.
  184.  
  185.  
  186.  
  187.     The following list would then be presented:
  188.  
  189.  ░░░░░░░ Press Alt-T to tag all - Alt-U to remove Tags. ░░░░░░░░░
  190.  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  191.  ░┌─[■]──────────TagFile v1.50 - Directory Lister──────────[ ]─┐░
  192.  ░│  HS-BOYAN.DOC   HSLK10C6.ZIP                               │░
  193.  ░│  HS-BOYAN.ZIP   HSLK10C7.ZIP                               │░
  194.  ░│  HS-D.BAT       HSLK10C9.ZIP                               │░
  195.  ░│  HS-INST.ZIP    HSLK10D1.ZIP                               │░
  196.  ░│  HS-R173C.ARJ   HSLK10D2.ZIP                               │░
  197.  ░│  HS-R173C.ZOO   HSLK10D3.ZIP                               │░
  198.  ░│ √HS-R173C.ZIP   HSLK1124.ZIP                               │░
  199.  ░│  HS-U.BAT                                                  │░
  200.  ░│  HS-WC215.DOC                                              │░
  201.  ░│  HS-WC215.ZIP                                              │░
  202.  ░│  HSLK10B7.ZIP                                              │░
  203.  ░│  HSLK10C4.ZIP                                              │░
  204.  ░├────────────────────────────────────────────────────────────┤░
  205.  ░└░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░┘░
  206.  ░░░░░░░░░░░ Press SPACE to select or ESC to finish. ░░░░░░░░░░░░
  207.  
  208.  
  209.     Alt T will tag all the listed files with a check mark.  As
  210.     shown on the HS-R173C.ZIP file in the tagging utility, a space
  211.     bar will tag single files.  When done tagging then simply hit
  212.     your escape key and the tagged files will be added to the list
  213.     you specified.  This menu also has mouse functions built into
  214.     it for your convenience.  You and stretch the window to your con-
  215.     venience and tag by clicking the mouse with the left button.
  216.  
  217.  
  218.  2. C = Change Tagfile name.  This is the list that you have specified in
  219.     the first line of your configuration file ( DGS.DEF ).  To change then
  220.     name of the file list simply execute this command and you will be prompted
  221.     for the new name and your configuration file will be changed accordingly.
  222.  
  223.  3. E = Edit your file list.  This function calls the editor you have named
  224.     on line 9 of your configuration file ( DGS.DEF ).  QEdit is recommended
  225.     for use here though any text editor ( NOT WORD PROCESSOR ) should work.
  226.  
  227.  4. K = Kill list of tagged files to start a new one.  This function
  228.     erases the list of tagged files so you can start a fresh new one
  229.     after you have uploaded to all your favorite BBSs.
  230.  
  231.  5. F = Add a file description to files in your tagged file list.  This is
  232.     for future use with RBATCH ( by Dan Shore ) on RBBS-PC BBS systems.
  233.     Creates preformated description files  writen with the Tagfile internal
  234.     editor.  ID.BAT ( included with TAGFILE ) will add the DIZ or SDI file to
  235.     your tagged file once you have written the description.   TAGFILE passes
  236.     the extension to the batch file when it calls it.  This file must be found
  237.     in the current subdirectory or in your DOS path.
  238.  
  239.       ID.BAT:
  240.       %1 = the full name and path of the tagged file
  241.       %2 = the name of your description file FILE_ID.DIZ or DESC.SDI or
  242.            whatever you choose to call it.
  243.       %3 = extension of the compressed file.
  244.  
  245.  
  246. @ECHO OFF
  247. GOTO %3 ELSE
  248. GOTO EXIT
  249. :ZIP
  250. pkzip %1 c:\logo\chatters.bbs
  251. ziplogo %1 c:\logo\logo.bbs
  252. pkzip -k %1 %2
  253. GOTO EXIT
  254. :PAK
  255. pak A %1 %2
  256. GOTO EXIT
  257. :ARC
  258. pak A %1 %2
  259. GOTO EXIT
  260. :ARJ
  261. arj a %1 %2
  262. GOTO EXIT
  263. :ZOO
  264. zoo a %1 %2
  265. GOTO EXIT
  266. :EXIT
  267.  
  268.  
  269.  6. PGUP = Upload files or Send tagged files to the Host from your system.
  270.         When pressing this key you will get a menu with the following
  271.         selections:
  272.  
  273.         │▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀│
  274.         │                    │░░
  275.         │      Download      │░░
  276.         │                    │░░
  277.         │ [Z] Zmodem Batch   │░░  Z = Upload tagged files using Zmodem
  278.         │ [G] Ymodem-g Batch │░░  G = Upload tagged files using Ymodem-g (MNP modems only)
  279.         │ [K] Ymodem Batch   │░░  K = Upload tagged files using Ymodem 1K
  280.         │ [H] HS/Link TwoWay │░░  H = Noted below
  281.         │ [B] BiModem TwoWay │░░  B = Noted below
  282.         │ [M] Puma Batch     │░░  M = Noted below
  283.         └────────────────────┘░░
  284.           ░░░░░░░░░░░░░░░░░░░░░░
  285.  
  286.           ESC will exit this menu.
  287.  
  288.     H = Upload tagged files using HS/Link.  This may be used to execute
  289.         a bidirectional transfer.  Tell the BBS you are calling that
  290.         you want to download a file using HS/Link.  When the system says
  291.         it is ready to send the file then shell to TAGFILE and execute the
  292.         "H" command and your bidirectional transfer will begin.
  293.     B = Upload tagged files using BiModem.  This may be used to execute
  294.         a bidirectional transfer.  Tell the BBS you are calling that
  295.         you want to download a file using BiModem.  When the system says
  296.         it is ready to send the file then shell to TAGFILE and execute the
  297.         "B" command and your bidirectional transfer will begin.
  298.     M = This is a totally configurable menu choice.  You can use this for
  299.         anything you wish: downloading with your favorite protocol,
  300.         uploading with your favorite protocol, compiling or whatever you
  301.         wish.  Tagfile will shell to whatever you call if it can find a
  302.         tagged filelist.  For an example I have included MPT ( Puma ) to
  303.         give you a feel for how it works.  Line 7 of your configuration
  304.         file ( DGS.DEF ) is the program to execute and parameters to pass
  305.         (if any).  Line 8 is the Menu Listing description.  The menu
  306.         will only list the first 21 chars of what you enter here so keep
  307.         it short.
  308.  
  309.  
  310.  
  311.  7. PGDN = Download files or recieve files to your system from the Host.
  312.         When pressing this key you will get a menu with the following
  313.         selections:
  314.         │▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀│
  315.         │                    │░░
  316.         │      Download      │░░
  317.         │                    │░░
  318.         │ [Z] Zmodem Batch   │░░  = Download using Zmodem
  319.         │ [G] Ymodem-g Batch │░░  = Download using Ymodem-g (MNP only)
  320.         │ [K] Ymodem Batch   │░░  = Download using Ymodem
  321.         │ [H] HS/Link TwoWay │░░  = Download using HS/Link *
  322.         │ [B] BiModem TwoWay │░░  = Download using Bimodem *
  323.         │                    │░░
  324.         └────────────────────┘░░
  325.           ░░░░░░░░░░░░░░░░░░░░░░
  326.  
  327.         * = Will execute bidirectional transfer if you have tagged files.
  328.  
  329.         ESC will exit this menu.
  330.  
  331.  8. S = Send Upload Command -  Send the upload command to the BBS.  THIS IS
  332.     ONLY TO BE EXECUTED WHILE YOU ARE ON LINE!     This command will send
  333.     the upload command to the BBS along with the names of all the files you
  334.     have tagged.  Depending on the system you call this may or may not
  335.     be an advantageous  feature for you to use.
  336.  
  337.  9. ESC = Quit or exit the program.
  338.  
  339.  
  340. Once you have tagged some files for uploading, dial your favorite BBS
  341. and have a good time transferring files.  Be sure to upload quality files.
  342. This makes your sysop infinitely happy.
  343.  
  344. Though TAGFILE will work on any BBS future enhancements will be more focused
  345. on compatibility with new and upcoming features of the RBBS BATCH uploading
  346. interface ( RBATCH ).  Future enhancements will include:
  347.  
  348.  
  349.    1.) Enhanced file description formats.
  350.    2.) User Suggestions!  Your input can only make this better!
  351.  
  352.  
  353. Tom Hansen, Sysop (DGS-Tango)
  354. CHURCH CHATTERS BBS   (402) 593-8863  HST
  355.                       (402)592-9266 Contributers HST
  356.  
  357.  
  358.  
  359.                    DGS - Dedicated to Great Support!
  360.  
  361. I want to thank the following people for helping to test TAGFILE and
  362. especially Dan Shore for writing RBATCH which was the inspiration for
  363. writing this to simplify batch uploading to RBBS-PC systems:
  364.  
  365. Dan Shore (DGS-Wonder)
  366. THE SHORELINE BBS     (301) 946-2771  HST
  367.  
  368. Walter Ames (DGS-Viper)
  369. THE WORLD OF GREYHAWK (410) 461-9943  Dual
  370.                       (410) 465-3891  Dual
  371.  
  372. Gregg Snyder (DGS-Alpha)
  373. THE ELUSIVE DIAMOND   (703) 323-6423  HST
  374.                       (703) 323-1782  HST
  375.  
  376.  
  377.               ------------------------------------------
  378.               TAGFILE WARRANTY, REGISTRATION AND SUPPORT
  379.               ------------------------------------------
  380.  
  381. Warranty & Disclaimer:
  382.  
  383. THIS PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  384. INCLUDING ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
  385. PURPOSE.  THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE
  386. PROGRAM IS ASSUMED BY YOU.  FURTHERMORE, I THE AUTHOR DO NOT WARRANT,
  387. GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE OF OR THE
  388. RESULTS OF THE USE OF THE PROGRAM, OR THAT THE PROGRAM WILL RUN WITHOUT
  389. ERROR, AND YOU RELY ON THE PROGRAM AND RESULTS SOLELY AT YOUR OWN RISK.
  390. I THE AUTHOR CANNOT ACCEPT RESPONSIBILITY FOR SYSTEM DAMAGE, LOSS OF
  391. PROFIT, OR ANY OTHER SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
  392. RESULTING FROM THE USE OR INABILITY TO USE THIS PRODUCT.
  393.  
  394. As always, with any new program, you should have a backup of your system.
  395.  
  396. You can always call my BBS and download the official version.
  397.  
  398.  
  399. Registration:
  400.  
  401. This program is being released under the "shareware" concept.  This means
  402. that you can try it out to see what it is like for a period of time.  If
  403. after a period of 60 days you continue to use it, then your registration
  404. is requested.
  405.  
  406. You can get your registered version one of two ways.  First, for $10.00,
  407. mail in the registration form with all the questions filled in.  You will
  408. then have to call my BBS and log on with the username and password that
  409. you supplied on the registration form and download the filename that I
  410. leave for you in a message. (This will be your registered version).
  411. Second, for $15.00, you can send me the registration form with all the
  412. questions filled in along with the size of the diskette you wish to receive
  413. (5 1/4 or 3 1/2). I will then mail you a diskette with your registered
  414. version of the program on it.
  415.  
  416.  
  417.  
  418.  
  419. Support:
  420.  
  421. If you do encounter any problems with the program, or have suggestions
  422. on improvements, you can call my BBS 24 hrs a day, and leave a message
  423. for me, or leave me a message on the RIME Network in the RBBS
  424. conference. I will consider the enhancements and of course try to fix
  425. any problems encountered with the program.  My BBS name & number is:
  426.  
  427.                          Tom Hansen
  428.                     "CHURCH CHATTERS BBS"
  429.                        USR HST 14.4k
  430.                        402-593-8863
  431.                      Proud Member of the
  432.                 - DGS Systems Group (Tango) -
  433.  
  434.                    Proudly Running RBBS-PC
  435.              "The Best BBS Software in the World"
  436.  
  437.                  Member of the RIME Network
  438.                     Node ID = OUTRIDER
  439.                     HUB  ID = HUBPADRE
  440.  
  441.   I will also be glad to talk voice with you if you wish, just leave
  442.        a message on the BBS or RIME and we can set up a time.
  443.